html 模式发布报表

表头固定

<report:html name="report1"

srcType="file"

reportFileName="api/wangge.rpx"

scrollWidth="300"         //滚动区域宽度

needScroll="yes"          //是否需要滚动

scrollHeight="200"          //滚动区域高度

scrollBorder="border:1px solid red"  //滚动区域边框

/>

◆ 参考文件：

    1.1.6.jsp

缩放

可以在标签里通过scale属性来指定报表缩放显示比例，默认情况下为1.0，我们可以直接设置scale属性来达到固定控制缩放比例，也可以用户传入参数，来达到自定义缩放比例要求：请参考例子1.1.7.jsp

◆ 直接指定缩放属性

<report:html name="report1"

srcType="file"

reportFileName="api/wangge.rpx"

......

scale="0.5"

/>

◆ 用户自定义缩放比例

<report:html name="report2"

srcType="file"

reportFileName="api/wangge.rpx"

scale="<%=request.getParameter("scale")%>"  //通过传递参数控制缩放比例

/>

◆ 参考文件：

  1.1.7.jsp

打印

使用needPrint启动打印功能,printLabel为打印功能按钮设置显示值,needDirectPrint属性启用直接打印, needSelectPrinter是否选择打印机,printedRaq设置后,展现与打印可以分别是不同的报表,appletJarName属性指定打印applet所在的位置,可以带路径.这个可以参看例子1.1.8.jsp

<%

String appmap = request.getContextPath();

String PrintImg = "<img src='" + appmap + "/images/print.gif' border=no>";

%>

<report:html name="report1"

reportFileName="api/wangge.rpx"   

needPrint="yes"

printLabel="点击进入打印预览"

needDirectPrint="yes"    //是否需要显示直接打印按钮 

needPrintPrompt="yes"   //是否立即打印（即是否弹出对话框询问是否打印）

needSelectPrinter="yes"    //是否需要选择打印机

savePrintSetup="yes"    //是否保存打印设置 

printedRaq="api/wangge_arg.rpx"    //打印的报表，此属性用于显示报表和打印报表不同

appletJarName="raqsoftReportApplet.jar"    //打印applet的jar文件名

/>

批量直接打印

客户端经常需要对报表进行批量打印，此时可以调用applet打印或者PDF打印进行批量打印操作，用法如下：

applet打印：

<%

//此JSP参数格式为：report={无参数报表名}{报表1(参数1=value1;参数2=value2;...)}{报表2(参数1=value1;参数2=value2;...)}...&prompt=yes&needSelectPrinter=yes

request.setCharacterEncoding( "UTF-8" );

String report = request.getParameter( "report" );

if( report == null || report.trim().length() == 0 ) throw new Exception( "请输入报表文件名及参数串report={无参数报表名}{报表1(参数1=value1;参数2=value2;...)}{报表2(参数1=value1;参数2=value2;...)}..." );

String prompt = request.getParameter( "prompt" );

String needSelectPrinter = request.getParameter( "needSelectPrinter" );

String pages = request.getParameter( "pages" );

String copies = request.getParameter( "copies" );

if( pages == null ) pages = "";

if( copies == null ) copies = "1";

String appmap = request.getContextPath();

String serverPort = String.valueOf( request.getServerPort() );

String serverName = request.getServerName();

String appRoot = "http://" + serverName + ":" + serverPort + appmap;

%> 

<object classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"  codebase="<%=appRoot%>/jre-6u24-windows-i586.exe#Version=1,6,0,0"  width="80" height="32" id="report1_directPrintApplet" style="vertical-align:middle">

<param name="name" value="report1_directPrintApplet"> 

<param name="code" value="com.raqsoft.report.view.applet.DirectPrintWithoutShow.class"> 

<param name="archive" value="<%=appmap%>/raqsoftReportApplet.jar"> 

<param name="type" value="application/x-java-applet;version=1.6"> 

<param name="appRoot" value="<%=appRoot%>"> 

<param name="dataServlet" value="/reportServlet;jsessionid=<%=session.getId()%>?action=1">

<param name="fileName" value="<%=report%>"> 

<param name="srcType" value="file"> 

<param name="fontFace" value="宋体"> 

<param name="fontSize" value="10pt"> 

<param name="fontColor" value="#808040"> 

<param name="backColor" value="#126356"> 

<param name="label" value="打印">  

<param name="needPrintPrompt" value="<%=prompt%>">

<param name="needSelectPrinter" value="<%=needSelectPrinter%>">

<param name="needSetPageSize" value="no">

<param name="scriptable" value="true">

<param name="paramCharset" value="UTF-8">

<param name="blackWhitePrint" value="no">

<param name="mirrorPrint" value="no">

<param name="icon" value="/raqsoft/images/print.gif">

<param name="copies" value="<%=copies%>">

<param name="pages" value="<%=pages%>">

<comment>

<embed type="application/x-java-applet;version=1.6" width="80" height="32" id="report1_directPrintApplet"

code="com.raqsoft.report.view.applet.DirectPrintWithoutShow.class"

archive="<%=appmap%>/raqsoftReportApplet.jar"

type="application/x-java-applet;version=1.6"

appRoot="<%=appRoot%>"

dataServlet="/reportServlet;jsessionid=<%=session.getId()%>?action=1"

fileName="<%=report%>"

srcType="file"

fontFace="宋体"

fontSize="10pt"

fontColor="#808040"

backColor="#126356"

label="打印"

needPrintPrompt="<%=prompt%>"

needSelectPrinter="<%=needSelectPrinter%>"

needSetPageSize="no"

scriptable="true"

paramCharset="UTF-8"

blackWhitePrint="no"

mirrorPrint="no"

copies="<%=copies%>"

pages="<%=pages%>"

icon="/raqsoft/images/print.gif">

</embed>

</comment>

</object>

打印其它相关知识:

1.  批量打印时，可以在第一张报表打印前弹出一个页面设置窗口，用户输入新的页面设置数据后，所有的报表都可以使用此设置进行打印

 方法：在directprint.jsp中增加下面的参数

 <param name="needSetPageSize" value="yes">

2.  批量打印时，也可以使用以前保存的客户端打印设置，在directprint.jsp中增加下面的参数

 <param name="savePrintSetup" value="yes">

3.  html报表、打印方式发布的报表、批量打印报表在打印完成后，均可以回调页面中的一个js函数，以便让用户可以实现打印后的处理事件.用户在页面中写一个名称为raqsoft_printOver()的javaScript函数，通过此函数实现打印后的处理

PDF打印：

<script language=javascript>

var myToast;

function showToast() {

myToast = $().toastmessage('showToast', {

text  : '<%=ServerMsg.getMessage(request,"jsp.loadingPrint")%>',

sticky  : true,

position : 'middle-center',

type:  'notice'

});

  }

function closeToast() {

$().toastmessage('removeToast', myToast);

}

</script>

……

<%

//此JSP参数格式为：report={无参数报表名}{报表1(参数1=value1;参数2=value2;...)}{报表2(参数1=value1;参数2=value2;...)}

request.setCharacterEncoding( "UTF-8" );

String report = request.getParameter( "report" );

if( report == null || report.trim().length() == 0 ) throw new Exception( "请输入报表文件名及参数串report={无参数报表名}{报表1(参数1=value1;参数2=value2;...)}{报表2(参数1=value1;参数2=value2;...)}..." );

String src = request.getContextPath() + ServletMappings.getMapping( "com.raqsoft.report.view.ReportServlet" ) + "?action=45&report=" + URLEncoder.encode( report, "UTF-8" );

String preview = request.getParameter( "preview" );

if( "no".equalsIgnoreCase( preview ) ) {

String url = appmap + ReportConfig.raqsoftDir + "/pdfjs/pdfDirectPrint.jsp?src=" + URLEncoder.encode( src, "UTF-8" );

%>

  <iframe src="<%=url%>" style="position:absolute;left:-100px;top:-100px" width=50 height=50></iframe>

<script language=javascript>

showToast();

</script>

<%

}

else {%>

<object classid="clsid:CA8A9780-280D-11CF-A24D-444553540000" id=pdfobj width="100%" height="100%" border="0">

<param name="_Version" value="65539">

<param name="_ExtentX" value="20108">

<param name="_ExtentY" value="10866">

<param name="_StockProps" value="0">

<param name="SRC" value="<%=src%>">

<comment>

<embed id=pdfobj1

type="application/pdf"

src="<%=src%>"

width="100%"

height="95%">

</embed>

  </comment>

</object>

<% } %>

PDF批量打印可访问pdfBatchPrint.jsp，示例url如：http://localhost:6868/demo/reportJsp/pdfBatchPrint.jsp?report={a.rpx}{b.rpx(bid=10248;eid=10250)}&preview=yes

当参数preview的值为no时，则为直接批量打印；无此参数或参数值不为no时，则为预览后批量打印。

本地批量直接打印

客户端经常需要对报表进行批量打印，此时可以调用本地打印进行批量打印操作，用法如下：

本地打印：

<%

//此JSP参数格式为：report={无参数报表名}{报表1(参数1=value1;参数2=value2;...)}{报表2(参数1=value1;参数2=value2;...)}...&prompt=yes&needSelectPrinter=yes

request.setCharacterEncoding( "UTF-8" );

String report = request.getParameter( "report" );

//"请输入报表文件名及参数串report={无参数报表名}{报表1(参数1=value1;参数2=value2;...)}{报表2(参数1=value1;参数2=value2;...)}..."

if( report == null || report.trim().length() == 0 ) throw new Exception( ServerMsg.getMessage(request,"jsp.dpArgError") );

String prompt = request.getParameter( "prompt" );

String needSelectPrinter = request.getParameter( "needSelectPrinter" );

String pages = request.getParameter( "pages" );

String copies = request.getParameter( "copies" );

String appmap = request.getContextPath();

String appRoot = ReportServlet.getUrlPrefix( request );

if( !appRoot.startsWith( "http" ) ){

String approot1 = request.getRequestURL().toString();

approot1 = approot1.substring( 0, approot1.indexOf( request.getRequestURI() ) );

appRoot = approot1 + appmap;

}

StringBuffer url = new StringBuffer( "printrpx://" );

url.append( "a=" + URLEncoder.encode( appRoot, "UTF-8" ) );

url.append( "&b=" + URLEncoder.encode( "/reportServlet;jsessionid=" + session.getId() + "?action=1", "UTF-8" ) );

url.append( "&c=" + URLEncoder.encode( report, "UTF-8" ) );

if( needSelectPrinter != null ) {

url.append( "&k=" + needSelectPrinter );

}

url.append( "&u=1" );

url.append( "&v=" + prompt );

url.append( "&x=UTF-8" );  //paramCharset

if( pages != null ) url.append( "&z=" + pages );

if( copies != null ) url.append( "&aa=" + copies );

url.append( "&ti=" + System.currentTimeMillis() );

%>

本地批量打印可访问directprint_local.jsp，示例url如：http://localhost:6868/demo/reportJsp/ directprint_local.jsp?report={a.rpx}{b.rpx(bid=10248;eid=10250)}

注意：

1. 如果rpx文件带参数，则必须要加{}大括号。

2. { }大括号、( )小括号这个2个特殊符号需要转码，分别对应为%7B、%7D、%28、%29。

导出

参看例子1.1.10.jsp

<report:html name="report1"

reportFileName="api/wangge.rpx"

needSaveAsPdf="yes"

pdfExportStyle="text,0" //表示导出文本方式的不分页的PDF文件

needSaveAsText="yes"

textDataSeparator=","    //存为Text时，同行单元格数据间的分隔符

needSaveAsExcel="yes"

needSaveAsWord="yes"

excelUsePaperSize="no"  //存为Excel时：yes按报表设计时的纸张尺寸，no采用本tag标签中指定的width，height值

excelPageStyle="1"  //存为Excel时的分页方式，不指定此属性值，则弹出对话框让用户选，0（不分页）或1（分页）

saveAsName="网格"  //报表另存为Excel、PDF、Word或Text时的文件名（不用带扩展名）

/>

浏览式报表

分页

参见例子1.1.11.1.jsp

<report:html name="report1"

reportFileName="api/wangge.rpx" 

width="1000"   //报表分页宽度

height="1000"    //报表分页高度

needPageMark="yes"  //是否显示报表页数及翻页功能

columns="2"    //分栏数

displayNoLinkPageMark="no"  //是否显示无超链接的页码标识（如第一页时的“最前页”和“上一页”

/>

缓存与实时报表

当且仅当raqsoftConfig.xml里的alwayReloadDefine属性设置为no时， tag标签中的useCache与timeout属性才会起作用，useCache属性控制是否启用缓存，而timeout为取多少长时间内生成的报表。这个可以参看例子1.1.11.2.jsp.建议大报表启用缓存。

<report:html name="report1"

reportFileName="api/wangge.rpx"     

useCache="yes"  //是否使用缓存

timeout="30" //从缓存系统中取多少分钟内产生的报表，如果没有此时间内的，则产生一个新报表

/>

折叠报表

◆背景说明

当某些分组报表的格式符合折叠报表的格式要求时，在web端是可以按照折叠报表的方式展现的。通常折叠报表用于大数据量的分组报表展现，以便能逐级展开/收拢查看。

折叠报表说明：

（1）  OLAP折叠报表（isOlap）和树形报表（isTreeTable）两种展现方式互斥，因此isOlap与isTreeTable不可以同时为yes

（2）  折叠报表同时支持固定表头

（3）  折叠报表不支持分页

（4）  折叠报表是js的功能，因此仅限于网页支持。打印和导出时与普通报表一致

（5）  树形报表对浏览器没有要求，OLAP折叠报表要求IE浏览器为IE9以上版本，其它类浏览器不限

（6）  树形报表格式要求：分组格与它的子格不在同一行上，不能有行上的全包含或半包含关系。

（7）  OLAP折叠报表格式要求：必须全包含，并且必须给每个分组都加上一个统计行，如果分组格是纵向扩展，统计行必须与分组格同行，如果是横向扩展，统计行必须与分组格同列。

◆树形折叠报表

首先，制作一个满足树形折叠报表格式要求的报表，比如该示例中的tree.rpx

然后，通过tag标签发布该报表：

<report:html name="report1"

reportFileName="api/tree.rpx"

isTreeTable="yes"  //以树形折叠报表展现

needScroll="yes"  //固定表头

foldIcon="arrow"  //折叠图标为箭头（plus或arrow）

foldOnBegin="2"  //初始可以看见2层（yes、no或整数）

/>

◆olap折叠报表

首先，制作一个满足olap折叠报表格式要求的报表，比如该示例中的olap.rpx

然后，通过tag标签发布该报表：

<report:html name="report1"

reportFileName="api/olap.rpx"

isOlap="yes"  //以OLAP式折叠报表展现

needScroll="yes"  //固定表头

scrollWidth="1000"//滚动区域宽度

foldIcon="plus"  //折叠图标为加减号（plus或arrow）

foldOnBegin="yes"  //初始全折叠（yes、no或整数）

/>

对于添加isOlap标签的折叠报表，如需自定义折叠和收起的图标，可替换[应用根目录]/raqsoft/images下的folded.gif、extended.gif 、foldedCol.gif 、extendedCol.gif即可

◆参考文件

1.1.12.a.jsp， 1.1.12.b.jsp

冻结表头

用户可以使用tag标签来冻结报表的表头。

html报表在JSP文件中用<prefix:html>标签来发布，prefix是用户在JSP文件头指定tag定义文件时指定的前缀名。该定义语句如下所示：

<%@taglib uri="/WEB-INF/raqsoftReport.tld" prefix="report"%>

此定义语句必须写在JSP的开头，其中prefix的值可以自己指定，但tag标签中的前缀必须与其保持一致。

在要发布报表的地方用上面介绍的tag标签来发布，在tag标签中用needScroll属性来指定是否冻结报表的表头，用scrollWidth和scrollHeight指定表头的宽度和高度。

needScroll：是否固定上表头和左表头。取值为yes或no，其中yes表示发布报表时冻结报表的表头，no表示发布报表时不冻结报表的表头，默认属性取值为：no。

scrollWidth：固定表头报表的显示宽度。取值为整数、象素值、百分数(如80%)，默认属性取值为：600。

scrollHeight：固定表头报表的显示高度。取值为整数、象素值、百分数(如80%)，默认属性取值为：400。

举例：

<report:html name=”report1”

reportFileName=”冻结表头.rpx”

needScroll=”yes”

scrollWidth=”650”

scrollHeight=”450”

/>

报表组

这里只讲解tag标签的使用。参见1.2.jsp

<report:group groupFileName="api/group.rpg"

border="4px double peachpuff "  //报表显示区边框，html边框表示法

margin="10"      //报表与报表显示区边框的距离，整数

tabFontColor="red"    // tab页字体颜色

tabHLFontColor="blue"  //当前tab页字体颜色

tabFontName="宋体"  // tab页字体名

tabFontSize="10px"  // tab页字体大小

useTabControl="yes"  //是否以TAB标签页的方式发布，如为no，则首先显示第一个，然后用户可下拉选择显示哪一个

needImportExcel="yes" //报表组中的填报表是否需要从Excel导入数据

tabLocation="top" // tab选项卡位置

/>

手机报表

◆手机端参数模板－1.1.2.e.jsp

制作手机报表时参数模板表单只有前两列有效，列宽设计无效。第一列是参数提示，第二列是输入区，第二列会与屏幕宽度自适应。除列数要求外，其他关于手机参数模板的制作与普通参数模板一致，这里只讲解tag标签的使用。

手机端参数模板可利用参数模板的tag进行发布，通过mobileMode属性设置是否使用手机模式发布。如使用手机模式发布需将mobileMode属性值设置为yes，并且通过resultPage属性跳转到结果页面。如下所示：

1.1.2.e.jsp：

<report:param name="param1" paramFileName="api/wangge_arg.rpx"

needSubmit="yes"

resultPage="/jsp/1.1.2.f.jsp?rpx= api/wangge.rpx"

mobileMode="yes"

/>

1.1.2.f.jsp：

<report:html name="report1"

srcType="file"

reportFileName="api/wangge.rpx"

funcBarLocation="top"

generateParamForm="no"

exceptionPage=" myError.jsp"

/>

<% 

//通过传递参数名和request请求获取参数值

String paramValue=(String)com.raqsoft.report.util.ReportUtils.getReportParamValue(request, "appellation");

out.println("appellation参数取得的参数值是："+paramValue);

%>